Q: Is there documentation for getattrlist (or any of the other Apple enhancements to the BSD file system programming interface)?
A: Click here to download documentation for the getattrlist, setattrlist, getdirentriesattr, searchfs, and exchangedata routines. This documentation comes in the form of man pages. You can install these man pages by unpacking the archive, opening a Terminal window, changing into the "qa1327" directory, and entering the commands shown in Listing 1. Once installed, you can read the documentation by entering man routinename in Terminal.
|
Listing 1. Installing the man pages.
|
guy-smiley:qa1327 quinn$ sudo cp *.2 /usr/share/man/man2
Password: *****
guy-smiley:qa1327 quinn$ sudo /usr/libexec/makewhatis
|
If you prefer to read this documentation as PDF, you can generate a PDF of these man pages using the pstopdf command. Listing 2 shows an example of how to do this.
|
Listing 2. Creating a PDF file from a man page.
|
guy-smiley:qa1327 quinn$ groff -msafer -mandoc -Tps getattrlist.2 \
| pstopdf -i -o getattrlist.pdf
|
These man pages will be included in a future revision of the Mac OS X developer tools (r. 2365648, 3448938, 2365653, 2365650).
|
IMPORTANT:
These routines are not supported by all volumes. The man page for each routine explains how you can test whether that routine is available on a particular volume.
|
|
IMPORTANT:
If you are a typical Macintosh application developer, you will not need to use these routines. You should, instead, call the Carbon File Manager. In many cases, the Carbon File Manager includes logic to emulate these routines on volumes that do not support them.
|
[Dec 15, 2003]
|
